home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / arc / uux10.lha / uux.doc < prev    next >
Text File  |  1993-02-09  |  6KB  |  144 lines
  1.            UUx 1.0 -- The Ultimate "UU" Utility for The Amiga
  2.            --------------------------------------------------
  3. Written by Asher Feldman
  4. -----------------------
  5.  
  6. Great, but what is it?
  7. ----------------------
  8. Hey, good question!  UUx is an "amigalized" uuencode/decode utility.
  9. Simply, it converts binary files to ASCII (and back, of course) so that
  10. they can be transmitted on mail-only networks, such as the UseNet or Portal.
  11. It is fully compatible with uuencode/decode utilities on other platforms,
  12. such as Unix, or Ibm. There are already many versions of uuencode and
  13. uudecode floating around for the Amiga, but they're all kinda archaic.  
  14. I mean, having separate utils for coding and decoding, and having to use
  15. redirection to encode a single file isn't exactly something a beginner can
  16. learn all that easy.  The syntax was also archaic and non-standard.  But
  17. more than that, UUx has features that can be found in no other single "UU"
  18. util, and does the work of several programs.  
  19.  
  20.  To encode the file myfile.lha with an old uuencode util entailed doing this:
  21.  
  22.               uuencode >myfile.uu myfile.lha myfile.lha
  23.  
  24.   Not a very pretty sight, especially if you're just starting out on a
  25. network.  The weird format was left over from unix systems, but I have no
  26. idea why.  Anyways, I decided to change things, so I wrote UUx, which has a
  27. modern, Amiga style interface, just like any Amiga archiver you're probably
  28. already accustomed to, such as LhA.
  29.  
  30. But wait, there's more!
  31. -----------------------
  32.   UUx doesn't just do "uudecoding", but also "uuconcacting" too.  That means
  33. it can take a uuencoded file that was created by joining several uuencoded
  34. files, with the headers left in, and still give you your binary file.  That's
  35. right, no more endless hours of editing mail headers, UUx takes care of that
  36. for you!
  37.  
  38. Using UUx 
  39. ---------
  40.   There are two versions of UUx included in this archive, "UUx" and "UUx030".
  41. "UUx030" is optimized to run on an 68030 equipped machine.  This version will
  42. crash when run on a 68000.
  43.  
  44. When you run UUx at the command line, you should get something like this:
  45.  
  46.      UUx Version 1.0 Copyright (c)1993 Asher Feldman     680x0 Version
  47.      USAGE: UUx [option] [archive name] <LhA archive name> <file(s) to encode>
  48.      options: a - encode           l - LhAencode                            
  49.               x - decode           u - LhAdecode
  50.  
  51.   UUx has four options to choose from.  You can encode or decode a file with
  52. the "a" and "x" options respectively.  Using the "l" option, you can do one
  53. step LhAing and uuencoding.  The "u" option will decode, and then automati-
  54. cally decompress a .lzh or .lha archive using LhA.  LhA is copyrighted 1992
  55. by Stefan Boberg.  It is the best archiver available for the Amiga as of this
  56. writing, and I highly recommend you register it.
  57.  
  58.   If I wanted to encode the file 'MyFile.lha' I would enter the following:
  59.  
  60.          UUx a myfile.lha.uue myfile.lha
  61.                ^^^^^^^^^^^^^^
  62.               Substitute whatever you want to call the encoded file here.
  63.  
  64.   If myfile.lha.uue already exists then you will be asked if you want to
  65. overwrite it. This is another nice feature, as the old uuencode/decode
  66. utils would overwrite the file without asking you. 
  67.  
  68.   Now to decode myfile.lha.uue, you would enter:
  69.  
  70.                   UUx x myfile.lha.uue
  71.  
  72.   If myfile.lha already exists, you will be prompted if you would
  73. like to delete it.
  74.  
  75.   If I had the files m1, m2, and m3 in the current directory, and wanted
  76. to LhA and uuencode them I could use:
  77.  
  78.            UUx l myfile.lha.uue myfile.lha m1 m2 m3
  79.  
  80.   "myfile.uu" will then be created, and will contain the LhA'd file
  81. "myfile.lha" which contains the files m1, m2 and m3. NOTE: When 
  82. using the "l" option, you MUST specify an LhA archive name, complete
  83. with the ".lha"!
  84.  
  85.   To automatically decode/de-lha the file "myfile.uu" I would use:
  86.  
  87.                    UUx u myfile.lha.uue
  88.  
  89.   If by any chance you get an "unexpected end of input" when you try to
  90. decode a .uue file, your file transferring procedure may be adding CR's or
  91. something to the file.   Use a CR-stripper, like TC or Filter, to remove
  92. them first, then decode the file.  When you get back on the board, see if 
  93. there's some CR setting you can adjust to eliminate them. If you still
  94. recieve an error message, then part of the uuencoded file has been cut off,
  95. or has been corupted. 
  96.  
  97. Info
  98. ----
  99.  The uuencoding routine used by UUx is originally by Mark Horton, and was
  100. modified by Alan Rosenthal and Bryce Nesbitt.  The routine is available on
  101. fish disk #92.  The routine was then further optimized by me, before
  102. inclusion in UUx.  The files produced by UUx are 100% compatible with all
  103. uudecoders, on all platforms.  The uunconc/uudecode code was ported by me
  104. from Un*x, and the original authors are unknown.
  105.  
  106. UUx will decode all uuencoded files (even if they still have mail headers,
  107. etc.  in them), from any source (unless they're corrupt.  :-) UUx was
  108. compiled on a 3.5meg A500 equipped with an 030/882 board using SAS/C 6.2.
  109.  
  110. UUx is Copyrighted (C)1993 by Asher Feldman.  You my freely distribute UUx,
  111. and use it for any non-commercial purpose you wish, as long as you leave the
  112. original files intact.  Commercial usage is prohibited, without written
  113. consent by the author.  If you like UUx, please feel free to send money to
  114. the address below.
  115.  
  116. You can contact me at the following addresses:
  117.  
  118. E-Mail
  119. ------
  120. PORTAL:       Wizard0                       
  121. Internet:     Wizard0@cup.portal.com      
  122.               asher@shell.portal.com
  123.  
  124. US Snail:   (send checks here :-)                                                     
  125.                                                               
  126.         Asher Feldman                                         
  127.         4791 Calle de Tosca             
  128.         San Jose, CA 95118
  129.  
  130.  
  131. And remember :
  132.  
  133. ONLY       _   C_o m m o d o_r_e   _                              
  134.           /\\  l\\   /l ll //  \  /\\                          
  135.          /  \\ l \\ /ll ll(< __  /  \\    MAKES IT POSSIBLE!!!!
  136.         /--- \\l  \X ll ll \\_ll/--- \\                        
  137.        /______________________________\\
  138.  
  139.  
  140.  
  141.  
  142.                                                     ** AF ** 
  143.  
  144.